home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / morse / mosh32 / mosh.doc < prev    next >
Text File  |  1996-05-14  |  16KB  |  327 lines
  1.                                      MOSH.DOC
  2.        ---------------------------------------------------------------------
  3.                  MOSH vers. 3.2, May 1996 
  4.                   In QBX Basic Compiler          
  5.                        by
  6.                    SM6KFY PETER HULTHE
  7.                      Address
  8.                  ***  Packet Mail  ***
  9.                 SM6KFY @ SK6YW.O.SWE.EU
  10.                   ***  Snail Mail ***
  11.                     Box 5014
  12.              426 05 VÄSTRA FRÖLUNDA, SWEDEN
  13.        ---------------------------------------------------------------------
  14.        With thanks for the timer routines to: 
  15.         *** Esko Lehtinen, ELogik Company in Gothenburg, Sweden.
  16.        With thanks for revising the English to: 
  17.         *** G0OIK Peter King in Flamstead, Great Britain.
  18.        ---------------------------------------------------------------------
  19.  
  20.        This programme was written to control the rig when sending CW to my
  21.        friend Peter/G0OIK. With this program your concentration can be
  22.        directed towards producing a good chat, while the machine takes over
  23.        routine keying.
  24.  
  25.        It was made to be as short and simple as possible, and was intended to
  26.        be run from DOS. It is possible to use a very simple PC, but a hard 
  27.        disk makes life easier. 
  28.        It is not recommended to be run from any integrated environment like 
  29.        Windows, Windows 95 or OS2. Only with DOS it gives the very exact 
  30.        timing of the Morse code that it was constructed for. It is possible 
  31.        to run a very fast CW with this programme.
  32.  
  33.        With a PC and a tape recorder it is possible to make your own CW
  34.        training tape. You can also practice the code with any text written in 
  35.        standard DOS formate.
  36.  
  37.        When sending or receiving with your rig, you simply write on the
  38.        keyboard. You can always (and as well as that) go over to the CW key
  39.        whenever you like. What you write on the keyboard is stored in the
  40.        log-file, which you can save or not at the end of your session as
  41.        you like.
  42.  
  43.        There are many nice CW programmes written. This is an attempt to make
  44.        a new one for all those who want a simple but efficiant programme,
  45.        filling the gap between the most basic and the more complicated
  46.        programs.
  47.  
  48.        ---------------------------------------------------------------------
  49.  
  50.        The head programme (MOSH.EXE) will automatically read the text file
  51.        (MOSH.CFG) during start-up.
  52.        By making changes in MOSH.CFG with a text editor (like the EDIT
  53.        supplied by DOS 5.0 and higher) you are able to make your own MOSH.
  54.        Points 1 - 12 will show what can be done.
  55.  
  56.        1.  Define your own characters (like national characters, KN etc.).
  57.        22 of the more seldom used keys (like {, (, ], [ etc.) can be
  58.        programmed to your own "Morse" code.
  59.  
  60.        2.  Set the CW-parameters to your own taste.
  61.        The length of Dits, Dahs and delays can be programmed, making
  62.        your Morse code personally coloured.
  63.  
  64.        3.  The default speed setting is done by MOSH.DEF.
  65.        Speed can then be adjusted up/down with the Left/Right arrows
  66.        or be set to "normal" by Home.
  67.        With some PC:s older than the 286, the speed will not always be
  68.        correctly reported on the screen. A calibration can then be done.
  69.  
  70.        For a calibration of speed, adjust to a reading of 15 wpm (words
  71.        per minute). Then run the file PARIS. To do this, hold down the 
  72.        ALT key and type "F". You will then be presented with a list of 
  73.        files. Enter the file name "PARIS". The word "PARIS" will be sent 
  74.        in CW to your loudspeaker 10 times.
  75.        The 10 "PARIS" should take exactly 44 seconds. With some older
  76.        PC:s, the wpm reading may prove to be a little slower speed than 
  77.        15 real wpm. If this is the case you may chose a higher wpm figure 
  78.        and make a note of the difference.
  79.        
  80.        4.  The loudspeaker sound frequency is determined by the MOSH.CFG
  81.        file, but it can also be changed when running the programme. The
  82.        Up/Down arrows will increase/decrease the frequency in steps by 
  83.        200 Hz for each touch. If the frequency is too high to the 
  84.        loudspeaker, you will not be able to hear it, but the rig will 
  85.        still be controlled.
  86.        PgUp and PgDn give 20 kHz resp. 200 Hz.
  87.        With End on your keyboard, the frequency is brought back to the
  88.        normal (default) value again.
  89.  
  90.        The loudspeaker is stopped/started with the Del key. In the
  91.        silent mode the rig is not affected by typing on the keyboard,
  92.        but the "silent text" will be stored in the log-file (if used).
  93.        This is a way to use the computer as a typewriter, during the
  94.        reception of CW or before a session, to make personal notes of
  95.        frequency, QRM level etc.
  96.  
  97.        5.  Define short standard texts to be sent using the shift/function
  98.        keys from within the MOSH.CFG file.
  99.        Up to 12 different messages ("quickies") can be programmed.
  100.        You may define the texts as you like. Max. length is 255
  101.        characters. Here some proposals:
  102.  
  103.        Shift/F1  : Own call-sign key
  104.        Shift/F2  : A commonly used counter-station
  105.        Shift/F3  : A short call to the commonly used counter-station
  106.        Shift/F7  : CQ-call
  107.        Shift/F10 : Over-and-out
  108.        
  109.        There are three "computer signs" that can be used when writing 
  110.        these short standard texts. Their use will add a time of day 
  111.        indication in the log.
  112.  
  113.        By holding down the right hand ALT on the keyboard and typing 157
  114.        on the numerical keypad you will produce a funny "Y" sign. When 
  115.        used at the end of the text, this will produce the K (Over-anyone 
  116.        to answer) code in CW, and also leave a time mark in the log.
  117.        Using ALT and 158 gives something like "Pt", producing a KN (Over- 
  118.        specified station to reply only) again with a time mark in the 
  119.        log.
  120.        ALT/159 gives a "ƒ", and is used to produce a time mark only, 
  121.        and will not give any audible code.
  122.  
  123.        6.  Define the directory name for texts to be sent from, floppy or
  124.        hard disk. The directory for these texts should be defined in the
  125.        MOSH.CFG file.
  126.        Files of up to 10 Kb of text can be sent in any speed you choose.
  127.  
  128.        ALT/F is used to send a text from floppy or hard disk, as was
  129.        explained in 3. above.
  130.  
  131.        Texts you want to send can be written using the normal EDIT
  132.        function under DOS and be stored under any legal filename.
  133.  
  134.        If you want to stop the text sending, press Esc to quiet it.
  135.        
  136.        7.  Define directory names for the log file and files to send. 
  137.        You may have a log-file generated after using MOSH. The file will 
  138.        be placed in a directory you may choose in MOSH.CFG.
  139.        
  140.        8.  The choice of COM-port is the last parameter in MOSH.CFG.
  141.        It is good to have a COM-port dedicated only to MOSH, but it is 
  142.        possible to combine the controlling of MOSH and other hardware 
  143.        using the same port.
  144.  
  145.        9.  Also some other details are controlled by MOSH.CFG (like the
  146.        colours of the written text on the screen, messages etc.).
  147.  
  148.        If you try to run MOSH32.EXE without the MOSH.CFG it is possible,
  149.        but some useful functions will not be present. Please note that
  150.        the two files must be kept in the same directory.
  151.  
  152.        10. Other options in the programme are some special keys:
  153.  
  154.        The BackSpace key produces a series of Dits (short signs). It
  155.        writes "Rub" on the screen and a text "RubOut" in the log-file.
  156.  
  157.        The keyboard buffer can be deleted (made empty) by Ctrl/Pause if
  158.        you want to rub out what is yet not sent. The Ctrl/Pause is
  159.        sometimes very valuable to use for deleting mistakes. Please try
  160.        to remember it and use it!
  161.  
  162.        The Ctrl/K key writes a "K" on the screen and in the log-file,
  163.        and makes the "K" Morse code. It also gives a time-mark in the
  164.        log-file for the next time a key is pressed.
  165.  
  166.        The Ctrl/O (not the figure!) writes a "Kn" on the screen and in 
  167.        the log-file, makes the "KN" code plus a time-mark in the log-
  168.        file.
  169.  
  170.        The Ctrl/T gives a time-mark in the log-file next time a key is
  171.        pressed.
  172.  
  173.        The Ctrl/U writes "Ok!" on the screen and in the log-file and
  174.        makes the Understood code (...-.). Also the exclamation mark "!" 
  175.        can be used for that.
  176.  
  177.        Ctrl/R clears the screen.
  178.  
  179.        Alt/L locks the key ON (for aerial tuning purpose). Another Alt/L
  180.        (or any character key) will unlock it.
  181.  
  182.        11. To send small texts in Beacon mode.
  183.        The Alt/B key starts/stops the beacon function, where you define
  184.        own beacon text and beacon delay. Max. length is 80 characters.
  185.        The standard texts can be used as beacons.
  186.        One word of warning: This function may be illegally used if you
  187.        lack a beacon permission and use it for on air transmission.
  188.  
  189.        12. To stop the programme.
  190.        The programme can always be stopped using ALT/X (also Esc works).
  191.  
  192.  
  193.        Help with the programme is always available with the F1 key (also
  194.        Alt/H). The Help Menu can always be consulted during the running of
  195.        the programme. There is no need to "escape" from help, just carry
  196.        on typing.
  197.  
  198.        ---------------------------------------------------------------------
  199.  
  200.        Interfacing hardware.
  201.  
  202.        There are two ways of interfacing the computer to the rig.
  203.  
  204.        
  205.        A. The loudspeaker method.
  206.        
  207.        To make a simple tap of the PC:s loudspeaker and to have the audio
  208.        converted into a conducting path will probably work well. An 
  209.        optocoupler (OC) is excellent for a job like that.
  210.        An OC is a light emitting diode (LED) and a photo transistor, housed 
  211.        in the same case, looking like an IC, often having 6 legs.
  212.        
  213.        The LED part (legs  1 - 2) is connected to the computer's loudspeaker 
  214.        via a 150 Ohm resistor. A 33 nF capacitor is connected across the LED 
  215.        terminals of the OC. The TL 111 and 4N25 OC:s were tried.
  216.        The transistor part of the OC (legs 4-5 are used, the emitter and
  217.        collector terminals) is connected to the rigs' key connections in such 
  218.        a way that the key current will flow through the transistor of the OC 
  219.        when the LED is lit by the loudspeaker current. A 1 nF capacitor 
  220.        across the key terminals is used to reduce any leaking RF energy.
  221.        This arrangement has worked well with an old XT and a 486 in my
  222.        shack, together with a Yaesu FT101ZD and an ICOM IC735.
  223.        However, with some PC:s and some rigs there can be problems. 
  224.        The generating of sound is not standardized within the PC concept. If 
  225.        the sound signal is too low, or if a polarizing voltage appears at the
  226.        connectors to the loudspeaker, an extra transistor before the OC may 
  227.        be needed. I have recently tried a Victor 286 which demanded for that 
  228.        solution.
  229.  
  230.        It maybe found with some older rigs that a transistor may be required 
  231.        between the rig and the OC. Connect the OC leg 4 to the base of the
  232.        transistor and the OC leg 5 to the collector (Darlington connection). 
  233.        The key connectors are then wired to the emitter and collector of the
  234.        transistor (only one polarity works!).
  235.  
  236.        
  237.        B. The COM port method.  
  238.        
  239.        An easy way to interface the PC to the rig is to use one of the 
  240.        COM-ports (sometimes called RS-232, or serial ports). They are male 
  241.        25 pin or 9 pin connectors at the rear of the PC, used for mice and 
  242.        modems. As it is good advice to electrically separate the PC from the 
  243.        rig I have been using an opto coupler to let the PC control the key
  244.        line.
  245.        TxD found in the COM-port is a connection used for data transfer.
  246.        It is pin 2 in the 25-p or pin 3 in the 9-p D-sub. Ground (GND) is
  247.        pin 7 in the 25-p or pin 5 in the 9-p D-sub. TxD is at about -12 V
  248.        negative with no tone present. When a CW tone is produced by MOSH, the 
  249.        TxD will go to a positive potential of +12 V on most PC:s. With some 
  250.        PC:s (particularly lap-tops) the potentials are lower (mostly + and 
  251.        - 5 V), but this should not change the function. 
  252.        
  253.        Connect TxD to the OC LED anode (pin 1) via a diode and a 2.2 kohm 
  254.        resistor. Connect the OC LED cathode (pin 2) to GND of the COM port. 
  255.        There will be a flow of about 5 mA from TxD to GND through the LED, 
  256.        when a CW tone comes. This will make the OC transistor conduct. 
  257.        For many rigs this conductance is enough to produce a sufficient key 
  258.        current to switch the rig into transmit mode. 
  259.        If not, a second transistor can be tried, making a Darlington stage 
  260.        together with the OC transistor. If also this fails, the voltage 
  261.        between the key terminals is not sufficient to supply the transistor. 
  262.        Then a 3 V external voltage in series with a 1 kohm resistor can 
  263.        help.
  264.        A capacitor of 0.1 uF is likely to be placed over the LED legs of the 
  265.        OC, and one of 1 nF over the transistor's legs to the rig's key line.
  266.        
  267.        The above methods have all been tried, and have solved all related
  268.        problems I have been faced to up till now.
  269.  
  270.        It has been observed that the the interface used for HamComm (by
  271.        DL5YEC) can use the same RS-232 port as MOSH. It will then be
  272.        possible to use any of the two programmes to control the CW keying
  273.        function, with the same opto-coupler CW interface.
  274.  
  275.        ---------------------------------------------------------------------
  276.        SUMMARY OF CONTROL FUNCTIONS:
  277.  
  278.        Arrows Up/Down       -Raise/Lower audio freq' from the PCs loudspeaker
  279.        PgUp                 -Highest setting, 20 KHz, gives quiet sending)
  280.        PgDn                 -Lowest  setting, 200 Hz)
  281.        End                  -Default setting of audio freq'
  282.  
  283.        Arrows Left/Right    -Increase/Decrease speed of CW
  284.        Home                 -Default setting of CW speed
  285.  
  286.        Delete               -Toggles between TX/RX. (In TX what is typed is
  287.                  sent, in RX what is typed is not sent, but is
  288.                  recorded in the Log-file).
  289.  
  290.        Backspace            -Sends error character and writes "Rub" on
  291.                  screen.
  292.  
  293.        Ctrl/K                Sends "K" (-.-) & makes time mark in log.
  294.        Ctrl/O               -Sends "KN" (-.--.) & makes time mark in log.
  295.        Ctrl/T               -Makes a time mark in the log.
  296.        Ctrl/R               -Clears the screen.
  297.        Ctrl/U  !            -Sends "Understood" (...-.) & writes "OK" in 
  298.                  the log.
  299.        Ctrl/Pause           -Clears the buffer and so stops sending.
  300.  
  301.        Shift/F1             -Sends pre-defined texts (like a CQ-call or what
  302.        ---                   you may have chosen.
  303.        Shift/F10
  304.  
  305.        Alt/B                -Starts/Stops beacon mode.
  306.        Alt/F                -To send pre-written text files.
  307.        Alt/H                -Shows help screen.
  308.        Alt/X                -Exits the program.
  309.  
  310.        F1                   -Shows the help screen.
  311.  
  312.        Esc                  -Stops the sending of text files
  313.                 -Also exits the program when no text file is
  314.                  being sent.
  315.  
  316.        ---------------------------------------------------------------------
  317.  
  318.        This programme is FREEWARE. It allows you to use it as much as you
  319.        like, as long as you want.
  320.  
  321.        If you find any errors, please tell me about them!
  322.        And if you have got any bright idea about changes, don't
  323.        forget to drop a few lines to me about that!
  324.  
  325.  
  326.        73 de SM6KFY / Peter
  327.